home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / Xpm / pixmap / README_R4_5 < prev    next >
Text File  |  1994-08-01  |  5KB  |  137 lines
  1. ** Copyright 1992 Lionel MALLET -- See licence conditions in file COPYRIGHT **
  2.  
  3.                 Pixmap version 2.0 R4/R5 version
  4.  
  5. WHAT IS Pixmap?
  6. ==============
  7.  
  8. Pixmap is a pixmap editor based on XPM version 3.2 library from Arnaud
  9. Le Hors - GROUPE BULL, derived from Davor Matic's bitmap editor (Davor
  10. Matic is member of the XConsortium AnneX).
  11.  
  12. Here is provided a program similar to the bitmap editor. As Bitmap, it
  13. provides facilities to edit pixmaps stored in files in XPM 3.2 format.
  14.  
  15. NOTE: The XPM library is mandatory. You should have got and installed
  16. it before proceeding.
  17.  
  18. See the Pixmap Manual (pixmap.man) for more details.
  19.  
  20. HOW TO GET Pixmap?
  21. =================
  22.  
  23. New pixmap updates are announced on the comp.windows.x newsgroup, and
  24. on the "pixmap" list. All new "official" pixmap releases can be
  25. found by ftp on:
  26.  
  27.     export.lcs.mit.edu (18.24.0.12) contrib     (Boston, USA)
  28.     avahi.inria.fr     (192.5.60.47) pub     (Sophia Antipolis, France)
  29.  
  30.  
  31. DOCUMENTATION:
  32. =============
  33.  
  34. Pixmap is not fully documented but is also self explanatory. A
  35. Reference Card in LaTeX format is joined which contains the main
  36. facilities of the editor: accelerator keys, resources, application
  37. files, ... The rest of the information can be found in the manual file
  38. pixmap.man.  We can mail you a PostScript version of the documentation
  39. if you are not able to print it (quite impossible).
  40.  
  41. INSTALLATION:
  42. ============
  43.  
  44. To obtain the Pixmap editor program, first uncompress and untar the
  45. compressed tar file (or unshar the shar file) in an approriate
  46. directory.
  47.  
  48. Pixmap only compiles with Imake.
  49. As Pixmap can have two different interfaces, based on Athena and
  50. Motif, (see MOTIF DISCUSSION about Motif version) you should look at
  51. the Imakefile to set the variables corresponding to the version you
  52. wish to obtain. The default version is the Athena one.
  53.  
  54. The variable of interest is USE_MOTIF (#define or #undef it as you like).
  55.  
  56. You should also look at the lines concerning the Pixmap.ad file creation.
  57.  
  58. In any case, you should set up the XPM relative variables correctly.
  59. These are XPM_INCLUDEDIR and XPM_LIBDIR.
  60.  
  61. Double check the Imakefile and type:
  62.  
  63.     xmkmf
  64.     make depend
  65.     make
  66.  
  67. which will build the pixmap program and its application defaults file. 
  68. Then do:
  69.  
  70.          make install
  71.     make install.man
  72.  
  73. which will install the program, application defaults file, the pixmap
  74. man page and the bitmaps used as image labels of buttons.
  75.  
  76. If it fails, you may edit the Imakefile to add compilation flags to
  77. suit your machine.
  78.  
  79. NOTE: A sample dotpixmap file (color configuration file) is created by
  80. the Makefile based on the rgb.txt file in /usr/lib/X11. You can
  81. extract parts of this file to build your own .pixmap file used by
  82. Pixmap.
  83.  
  84. NOTE: This version is an intermediate between R4 and R5. It provides
  85. R5 include files missing in R4. Thus, if you are already running R5,
  86. you can remove the files Xfuncs.h, Xosdefs.h and Xfuncproto.h under
  87. pixmap/X11 directory.
  88.  
  89. CONVERTERS:
  90. ==========
  91.  
  92. In the Xmu directory you can find different converters about XPM.
  93. These are converters that can be installed in an application to allow
  94. specification of pixmap resources in .Xdefaults and application
  95. default files.  No Makefile or Imakefile is provided to compile or
  96. install them. However, someone is currently working on converters to
  97. allow full use of the Xpm library features through resources.
  98.  
  99. MOTIF DISCUSSION:
  100. ================
  101.  
  102. The Motif version was tested under X11R4 with Motif 1.1. It currently
  103. works under X11R5 by removing all callbacks of Activate callback list
  104. of all components (buttons and text) of dialogs (SelectionBox). The
  105. main problem comes from an incompatibility between X11R5 and Motif 1.1
  106. (1.1.4 will work with MotifBC set during compilation of X) causing
  107. XtCallCallbackList to pass a null widget as first argument. This
  108. doesn't seem to be right for Motif 1.1 internal callbacks (and we can
  109. understand why!).
  110.  
  111. KNOWN PROBLEMS:
  112. ==============
  113.  
  114. The accelerators don't seem to work with Athena with X11R4.
  115.  
  116. Sometimes pixmap stops when not able to malloc memory after a few
  117. loading ops. 
  118.  
  119. DISCUSSION:
  120. ==========
  121.  
  122. There is a mailing list to discuss about Pixmap which is 
  123. pixmap@sophia.inria.fr.
  124. Any request to subscribe should be sent to pixmap-talk-request@sophia.inria.fr.
  125.  
  126. COPYRIGHT:
  127. ==========
  128.  
  129.   Copyright 1991, 1992 Lionel MALLET --
  130.   See licence conditions in the COPYRIGHT file of the Pixmap distribution
  131.  
  132. Please mail any bug reports or modifications done, comments, suggestions,
  133. requests for updates or patches to port on another machine to:
  134.  
  135. pixmap@sophia.inria.fr        (INTERNET)
  136.  
  137.